License Data tokens

SoftwareShield License Manager > Working With A License Project > IronWrapping™ Tab > User Interface Tab > HTML Reminder Tokens > License Data Tokens

## License Data Tokens

These tokens have the form "%TokenName%". They are replaced at run-time with information gathered from the license itself or from the IronWrap operating environment. Some tokens only apply to certain license models. Here is an example of using a License Data Token:
<a href="%SupportURL%" target="_blank">Support</a>

%ApplicationName% = Replaced at run-time with the name of the application. This is taken from the Host Product field on the General Tab of the License Project.

%Daysleft% = (only applies to trial model #1 or expire period) Replaced at run-time with the total number of days left until the application expires. Note, the difference, in days, between the current date and time and the expire date and time measured only in whole days. Thus, the difference between Dec 31, 1999 11:59 PM and Jan 1, 2000 11:58 PM has a %DaysLeft% value of 0 because the difference is one minute short of an entire day.

%ExpireDateTime% = (only applies to trial model #1 or expire period) Replaced at run-time with an absolute point in time when the application expires. This will be formatted with the systems current locales short date time format.

%ExpireTotalMinutesLeft% = (only applies to trial model #2 or expire duration) Replaced at run-time with the total number of minutes left in a trial.

%HostFilePath% = Replaced at run-time with the fully qualified path to the host application directory. (Used for locating images in HTML reminders). Be sure that any images you include in your HTML reminder are formatted in this way: <img src="%HostFilePath%imagename.jpg" />. The IronWrap linker will take care of the rest as long as it can find your source image file.

Note: Fully qualified paths must be expressed with backslashes ( \ ).

For example:

Incorrect: <img src="%HostFilePath%images/imagename.jpg" />.

Correct: <img src="%HostFilePath%images\imagename.jpg" />.

%BuyNowURL% = Replaced at run-time with the full URL to the purchase page for this product. This is taken from the URLs Tab in your license project.

%ProductInfoURL% = Replaced at run-time with the full URL to a page that gives more information on the product. This is taken from the URLs Tab in your license project.

%UpdatesInfoURL% = Replaced at run-time with the full URL to the page that allows the user to register for updates or information / newsletters etc. This is taken from the URLs Tab in your license project.

%AuthRequestCode% = Replaced at run-time with the Authorization Request Code of Release Copy Protection. This required for Simple Code Exchange scenarios.

%LanguageOptions% = Replaced at run-time with a list of languages in a specific HTML format. This is primarily used to change the language of the HTML form. When the user successfully changes the language using this mechanism, the HTML reminder form closes and instantly re-opens with the newly selected language. From that point forward the IronWrapping system will use this language in all UI. Note that if you are only using a single language (Fall_Back) then this token is unnecessary and will be replaced with nothing (making an empty combo-box).

The format that of the list is as follows:

<option selected="selected" value="0x1009">English (Canada)</option>
<option value="0x0004">Chinese (Any)</option> <option value="0x0005">Czech (CS)</option>

%LanguageOptions% must be placed within a select tag that with the name "LangID". It should look like as follows:

<select name="LangID">

The select control must appear inside a "form" tag in the format:

<form action="close:SelectLang" method="GET">

Note the action must be "close:SelectLang" and the method must be "GET".

Lastly, the form must also contain a button to submit the form in the form:

<input style="font-size:10px" type="submit" value="Go" />

Here is a complete example:

<form action="close:SelectLang" method="GET">
<select name="LangID">
%LanguageOptions%
</select>
<input type="submit" value="Go" />
</form>

Alternatively, you can use a javascript onChange event in place of the submit button to initiate the language change. Note: that the javascript will not run if the client has their security policy to disable javascript by default.